home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro225 / gold.doc < prev    next >
Encoding:
Text File  |  1993-07-10  |  2.8 KB  |  66 lines
  1. File GOLD.DOC (MSUGOLD.DOC)                                          July 1993
  2.  
  3.           SIMULATING THE DEC GOLD KEY WITH NUM LOCK
  4.  
  5. GOLD.COM (MSUGOLD.COM) is a simple TSR (Terminate and Stay Resident) program
  6. intended to make it easier to use MS-DOS Kermit as an emulator for DEC VT100
  7. and higher model VT series terminals on a PC with an enhanced keyboard (the
  8. one with separate numeric pad and cursor keys).  GOLD.COM was written by Bob
  9. Eager, E-mail: rde@ukc.ac.uk, phone: +44 227 764000 ext 7589.
  10.  
  11. GOLD makes the Num Lock key generate the code for the F1 key, \315, which is
  12. normally mapped by Kermit to the VT terminal's GOLD key.  This makes it
  13. possible (by using Kermit's SET KEY command) to make the PC keypad look almost
  14. exactly the same as the VT terminal keypad (the long + key is the only
  15. exception; that is two keys on the real terminal).
  16.  
  17. To use GOLD, simply place the GOLD.COM file into a directory on the normal
  18. program path, then type the command:
  19.  
  20.   GOLD
  21.  
  22. This activates the program, and Num Lock will cease to work as Num Lock and
  23. will instead operate the same as the F1 key.  This may not always be
  24. convenient, so it is possible to turn off the effect by typing:
  25.     
  26.   GOLD OFF
  27.  
  28. and later to turn it on again by typing:
  29.  
  30.   GOLD ON
  31.  
  32. The current GOLD state may be displayed by typing:
  33.  
  34.   GOLD
  35.  
  36. (after the first call, this is the only effect if the command is used without
  37. parameters).  The program can be set to an initial OFF state by calling it
  38. with the OFF parameter if required.  Later calls operate with the initially
  39. installed copy of the program, which cannot be unloaded (it is, however, very
  40. small; only 352 bytes of memory are required).
  41.  
  42. NOTES:
  43.  
  44. GOLD "locks" the keypad in whatever state it found it.  That is, if Num Lock
  45. was ON when you started GOLD (or gave a GOLD ON command), the keypad generates
  46. numbers.  If Num Lock was OFF at that time, the same keys generate their
  47. other scan codes, i.e. Home, PgUp, arrows, etc.
  48.  
  49. Some machines might not contain BIOS support for this program; in such cases,
  50. an error message is given on the first call of GOLD.
  51.  
  52. GOLD does not chain interrupts, and therefore will interfere with other TSRs
  53. that want to handle keyboard interrupts.
  54.  
  55. The program uses the INT 2FH multiplex interrupt to install itself; it uses
  56. a multiplex ID of 0DCH.  This may be changed if it clashes with other TSR
  57. programs.  The key to which Num Lock is mapped may also be changed.
  58.  
  59. Alteration of the above items is obvious on examination of the program source
  60. code.  If you do not have MASM, it is easy to patch the program since the
  61. relevant values are stored in easy to find places - offsets 102H and 103H.
  62. Source code is not included on the MS-DOS Kermit diskette, but is available
  63. on Kermit Distribution Tape A.
  64.  
  65. (End of GOLD.DOC / MSUGOLD.DOC)
  66.